home *** CD-ROM | disk | FTP | other *** search
/ Mac Format 1994 August / August CD.bin / Shareware / Applications / Invis Snds / About Invisible Clock 2.0 next >
Text File  |  1994-06-05  |  9KB  |  120 lines

  1.  
  2. A b o u t   I N V I S I B L E   C L O C K   2 . 0
  3. by Chris Holmes
  4.  
  5.  
  6. WHAT IS INVISIBLE CLOCK?
  7. =========================
  8. Invisible Clock is a small System 7-only Apple Macintosh utility that audibly announces the time between the hours you choose every hour, half-hour, or quarter-hour as you prefer at the volume you decide.
  9.  
  10. Actually, it’s a pair of applications: “Invisible Clock” and “Invisible Clockwork.” Invisible Clockwork does the announcing. Whenever it’s running, it sits quietly in the background except to announce the time every so often. You use Invisible Clock to tell Invisible Clockwork when, how often, and how loud to announce.
  11.  
  12.  
  13. INSTALLING INVISIBLE CLOCK
  14. ==========================
  15. You must be running System 7.0 or later on your Macintosh to use Invisible Clock.
  16. Invisible Clock 2.0 does not work on the Macintosh Plus, SE, or Classic.
  17.  
  18. Move the application “Invisible Clockwork” to the Startup Items folder of your System Folder.
  19.  
  20. Move the file “Invisible Clock Sounds” (and, if you have it, “More Invisible Clock Sounds”) to the Preferences folder of your System Folder.
  21. If you're using alternative sounds files, such as “Invisible Joanne Sounds,” first rename the files as “Invisible Clock Sounds” and “More Invisible Clock Sounds”.
  22.  
  23. Move the application “Invisible Clock” to the Control Panels folder in your System Folder. Double-click on it to set your preferences.
  24.  
  25. Invisible Clockwork will start automatically whenever you start your Macintosh. You may also choose Start Announcing from the File menu in Invisible Clock to start Invisible Clockwork. Use Balloon Help in Invisible Clock for instructions on setting your preferences.
  26.  
  27.  
  28. WHAT DID I JUST DO?
  29. ===================
  30.  
  31. Invisible Clock
  32. --------------
  33. Invisible Clock lets you set different preferences for each day of the week. Hold down the Option key when you click on a button, menu, or slider to change its setting for all days. Use System 7’s Balloon Help for more information about each of Invisible Clock’s controls.
  34.  
  35. Once your preferences are set, quit Invisible Clock. Invisible Clockwork does the announcing.
  36.  
  37. Invisible Clockwork
  38. ------------------
  39. Invisible Clockwork is a background-only application, so it doesn’t have any menus or windows and you can’t choose it from the Application menu on the right side of your menu bar. To quit Invisible Clockwork, start the Invisible Clock application and choose Stop Announcing from the File menu.
  40.  
  41. Once Invisible Clockwork is in your Startup Items folder, it will automatically start every time you turn on your Macintosh. If you don’t want this to happen, you may also move it to your Preferences folder or leave it in the same folder as Invisible Clock.
  42.  
  43. To temporarily keep Invisible Clockwork from automatically starting, start your Mac with the Shift key held down until you see the message, “Welcome to Macintosh! Extensions off.” (Turning off extensions also turns off startup items.)
  44.  
  45. Invisible Clock Sounds and More Invisible Clock Sounds
  46. -------------------------------------------------
  47. Invisible Clock Sounds contains the sounds Invisible Clockwork needs to announce the day and time accurately to within fifteen minutes.
  48.  
  49. More Invisible Clock Sounds contains the sounds Invisible Clockwork needs to announce the time accurately to the minute. Since Invisible Clockwork announces only every fifteen minutes, you probably won’t need this 200K file. If you use Apple events to announce the time with Invisible Clockwork, you’ll want to install this file.
  50.  
  51. You can double-click on the Invisible Clock Sounds and More Invisible Clock Sounds files in the Finder for an audible explanation about them.
  52.  
  53.  
  54. CHANGES SINCE INVISIBLE CLOCK 1.0.1
  55. ===================================
  56. Invisible Clock is more invisible than ever. The part of Invisible Clock that must be running to announce the time has been moved to the background-only application Invisible Clockwork, so you’ll never have to put up with Invisible Clock always appearing in your Application menu.
  57.  
  58. You can set different preferences for each day of the week.
  59.  
  60. Sounds are now played asynchronously, so your Mac won’t seize up while the time is being announced.
  61.  
  62. The time can be announced at a volume independent of the volume you’ve set in the Sounds control panel.
  63.  
  64. You can announce the time with Apple events and AppleScript.
  65.  
  66. With the file More Invisible Clock Sounds installed, announcements will be accurate to the minute all the time.
  67.  
  68. Setting the From hour to the same hour as the Until hour now announces the time only at the top of that hour. Previously, this told Invisible Clock to announce the time all day.
  69.  
  70. Invisible Clock 2.0 does not work on the Macintosh Plus, SE, or Classic.
  71.  
  72.  
  73. ANNOUNCING THE TIME WITH APPLESCRIPT AND APPLE EVENTS
  74. =======================================================
  75. You can announce the time from AppleScript or another application by sending an Apple event to Invisible Clockwork. Make sure the file “More Invisible Clock Sounds” is in your Preferences folder, otherwise Invisible Clockwork will only tell you “about” what time it is.
  76.  
  77. In AppleScript, tell Invisible Clockwork announce the time as shown in the following example script:
  78.     tell application "Invisible Clockwork" to announce time
  79. (Alas, last minute testing revealed that if Sound Manager 3.0 is installed, the time announcement will be clipped unless Invisible Clockwork is already running.)
  80.  
  81. From other applications, send an Apple event of class 'Annc', ID 'Time' to Invisible Clockwork to announce the time. You can also send the standard Open Application and Quit Application events.
  82.  
  83. If you send an Apple event to announce the time while Invisible Clockwork is announcing, the event will be ignored. If you send an Apple event to quit Invisible Clockwork while it’s announcing, it will quit when the announcement is complete.
  84.  
  85. For more information about AppleScript, check out Derrick Schneider’s AppleScript tutorial, “The Tao of AppleScript,” which comes complete with AppleScript and several useful scriptable applications. It’s available through BMUG. For more information about BMUG, start Invisible Clock and choose About Invisible Clock from the Apple menu.
  86.  
  87.  
  88. CONFLICTING SETTINGS
  89. =====================
  90. It’s possible to set overlapping announcement preferences with Invisible Clock. Each day’s preferences apply from the From hour on that day until the next Until hour.
  91.  
  92. For example, you could set Friday’s preferences to announce every quarter-hour from 9AM until 2AM (that is, 2AM Saturday morning). Meanwhile, Saturday’s preferences may be set to announce every hour from 1AM until 5PM.
  93.  
  94. In such cases, the previous day’s settings will override the current day’s settings. In this example, Friday’s preferences will make Invisible Clockwork announce every quarter-hour until 2AM Saturday morning, despite Saturday’s preferences to announce only once an hour after 1AM.
  95.  
  96.  
  97. CUSTOMIZING THE SOUNDS FILE
  98. ============================
  99. The file “Invisible Clock Sounds” and “More Invisible Clock Sounds” contain digitized voice in 'snd ' resources. Using a sound editing program such as SoundEdit Pro, you can record your own voice for announcing the time. Just replace any 'snd ' resource with another of the same name. See the file “About Invisible Clock Sounds” for more information.
  100.  
  101.  
  102. DETAILS
  103. ========
  104. Invisible Clockwork will not announce the time if the speaker volume is set to zero in the Sounds control panel.
  105.  
  106. As an application, Invisible Clock doesn’t officially belong in your Control Panels folder. It doesn’t matter where Invisible Clock is, though, as long as you don’t keep it in the Startup Items folder.
  107.  
  108. When you double-click on Invisible Clockwork, the icon will gray-out as any other application icon does. Unfortunately, when you quit Invisible Clockwork, the icon may remain grayed-out. As a programmer, I have no control over this. It’s simply an anomaly of how the Finder deals with background-only applications.
  109.  
  110.  
  111. LEGAL
  112. ======
  113. Invisible Clock © 1993 Chris Holmes (coHolmes@aol.com). System 7.0 or later required. Does not work on the Macintohs Plus, SE, or Classic. May not be distributed commercially without permission of the author. May be distributed by user groups and on-line services for a reasonable service fee. To allow more efficient downloading from on-line services, Invisible Clock may be freely distributed as
  114.  
  115. 1) one set of files including the applications “Invisible Clock” and “Invisible Clockwork” and the files “About Invisible Clock 2.0”, “Invisible Clock Sounds”, “More Invisible Clock Sounds”, and “About Invisible Clock Sounds”; or
  116.  
  117. 2) two sets of files, the first including “Invisible Clock”, “Invisible Clockwork”, “About Invisible Clock 2.0”, “Invisible Clock Sounds”, “About Invisible Clock Sounds”, the second including “More Invisible Clock Sounds”.
  118.  
  119.  
  120. About Invisible Clock 2.0, revision 2.0